home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 24 / AACD 24.iso / AACD / Graphics / vpeg / vpeg.doc < prev    next >
Text File  |  2001-06-10  |  4KB  |  127 lines
  1. Introduction
  2. ~~~~~~~~~~~~
  3.  
  4. VPeg is a mpeg-player (video and/or audio) for hardware such as the Peggy+ and
  5. CD³² FMV module, or any other hardware using the mpeg.device API (limitations
  6. of the corresponding hardware and/or driver apply), that said, this software
  7. has currently only been tested on Peggy+, feedback on others appreciated...
  8.  
  9.  
  10. Features
  11. ~~~~~~~~
  12.  
  13. · VCD *and* CDi support.
  14. · Alternate mpeg.device selection.
  15. · Multiple input-files and wildcard support.
  16. · Can scan for mpeg-data in files which contain prepended junk.
  17. · Lots of strange options you have to play around with to figure out what
  18.   they do. ;)
  19.  
  20.  
  21. Usage
  22. ~~~~~
  23.  
  24. VPeg takes any number of input-file arguments with or without wildcards, example:
  25.  
  26.  "vpeg whatever.mpg series#?.mpg" - plays whatever.mpg and series[#?].mpg
  27.  
  28.  
  29. Also it can find mpeg-data within a file prepended with junk and start playback
  30. at the correct position:
  31.  
  32.  "vpeg junkinfront.mpg FINDSYNC" - will scan junkinfront.mpg for mpeg-sync.
  33.  
  34.  
  35. It can also clear the custom-chip video-data (if f.ex. you've run AddAudioModes)
  36. by opening and closing a PAL/NTSC screen so that video will play back properly:
  37.  
  38.  "vpeg whatever.mpg NEWSCREEN"
  39.  
  40. ..or, if you want to open and keep a new screen for the duration of playback
  41. (if f.ex. you already have a custom-chip screen open and in use):
  42.  
  43.  "vpeg whatever.mpg NEWSCREEN KEEPSCREEN"
  44.  
  45. ..what screenmode to use is usually decided through reading the system EClock,
  46. but you can override this with DISPLAY:
  47.  
  48.  "vpeg whatever.mpg NEWSCREEN KEEPSCREEN DISPLAY=NTSC"
  49.  
  50. ..but if you have a Peggy Video Converter module all you need is:
  51.  
  52.  "vpeg whatever.mpg CONVERTER"
  53.  
  54.  
  55. To play a VCD/CDi you will have to supply a dummy input-file argument (due to
  56. the nature of ReadArgs()):
  57.  
  58.  "vpeg whatever VCD DEVICE=cybppc.device UNIT=4"
  59.  
  60.  
  61. If you don't have a Peggy+ but some other hardware decoder, you have to select
  62. another mpeg.device (be *VERY* careful of what you select here, anything other
  63. than a mpeg.device can destroy data), f.ex. for the CD³² FMV module:
  64.  
  65.  "vpeg whatever.mpg MPEGDEVICE=cd32mpeg.device"
  66.  
  67.  
  68. During playback you can control certain things through the use of break-signals:
  69.  
  70. CTRL-C - Stop all playback and quit.
  71. CTRL-D - Skip current file/track.
  72. CTRL-E - Pause/Resume playback.
  73. CTRL-F - Forward Search/Resume playback.
  74.  
  75.  
  76. The VERBOSE option will output details on your hardware decoder and progress
  77. information as well as statistics on the files/VCD/CDi...
  78.  
  79.  
  80. For more options, see below...
  81.  
  82.  
  83. Arguments
  84. ~~~~~~~~~
  85.  
  86. FILE/A/M           - Input file(s) to play, accepts multiple inputs and wildcards.
  87. FINDSYNC/S         - Scan file for sync (nice for files with junk infront).
  88. NEWSCREEN/S        - Open and close a new screen (to clear f.ex. AddAudioModes).
  89. KEEPSCREEN/S       - Keep the screen open until playback is finished (only with NEWSCREEN).
  90. DISPLAY/K          - Accepts PAL or NTSC, default is selected from EClock.
  91. KEEPAUDIO/S        - Don't close Peggy+ audio resources.
  92. KEEPVIDEO/S        - Don't close Peggy+ video resources.
  93. NOPLAY/S           - Do everything but actual playback.
  94. YCBCRMODE/S        - Output in YCbCr video-mode.
  95. PVC=CONVERTER/S    - Output through Peggy Video Converter module.
  96. VOL=VOLUME/N       - Sets volume (0-65535), only 0 (mute) makes a difference on Peggy+.
  97. OP=OPACITY/N       - Sets opacity (0-65535), only 0 (blank) makes a difference on Peggy+.
  98. L=LOOPS/N          - Loop video x times, 0 means forever.
  99. JL=JUSTIFYLEFT/N   - Adjust picture (in halfpixels) from the left, default is center (0).
  100. JT=JUSTIFYTOP/N    - Adjust picture (in pixels) from the top, default is center (0).
  101. VCD/S              - VCD/CDi mode, be sure to give a dummy FILE argument.
  102. DEV=DEVICE/K       - SCSI device to check for VCD/CDi disc.
  103. U=UNIT/N           - SCSI unit to check for VCD/CDi disc.
  104. MPDEV=MPEGDEVICE/K - Playback device (f.ex. cd32mpeg.device), default is peggympeg.device.
  105. VERBOSE/S          - Output progress and device information.
  106.  
  107.  
  108. Future
  109. ~~~~~~
  110.  
  111. I'm very busy these days, but if I find the time, here's a few features I'd
  112. like to add (in no particular order):
  113.  
  114. · Full-featured GUI.
  115. · Prefs
  116. · Internal demuxer.
  117. · Internal SCSI-support.
  118.  
  119.  
  120. Author
  121. ~~~~~~
  122.  
  123. Sigbjørn (CISC) Skjæret <cisc@c2i.net>
  124.  
  125. Bugreports and/or feature-requests are welcome, even better if you sent me
  126. the fix... ;)
  127.